home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d883.lha / BBBBS / BBBBS59.lha / Information / BBBBS.DOC < prev    next >
Text File  |  1993-06-11  |  36KB  |  899 lines
  1.                              11 Jun 1993
  2.  
  3.     BBBBS - Baud Bandit Bulletin Board System for the Amiga - BBBBS
  4.  
  5.  
  6. *****************************  Features  *****************************
  7.  
  8. Up to 99 file libraries with extended filenotes.
  9. Up to 99 fully threaded message conferences.
  10. Number of users, files, messages, etc. are only limited by storage space.
  11. Controlled file library and message conference access for users & sysops.
  12. Interface to extra devices like CD-ROM & others, all treated as Read-Only.
  13. Complete Email area including binary mail, and multiple forwarding.
  14. User statistics including messages written, files ul/dled, time, etc.
  15. RexxDoors sub-area, Grin_du_Jour, StarTrek, Wheel_Of_Fortune, much more!
  16. Searches: Search users, file descriptions, or messages.
  17. Online Text Editor: with Cut and Paste, Replace, and Spellchecking.
  18. Separate multi-tasking module for local sysop logon.
  19. User profiles, Polling_Place (a voting booth), background archiving.
  20. Complete offline read/reply/upload/download module, bbsQUICK.rexx.
  21.  
  22.  
  23.  
  24. *****************************  Contents  ****************************
  25.  
  26.  1. Copyright and Distribution Information
  27.  
  28.  2. Requirements
  29.  
  30.  3. Organization
  31.  
  32.  4. Setting Up
  33.  
  34.  5. User data
  35.  
  36.  6. bbsLOCAL.rexx
  37.  
  38.  7. Macros
  39.  
  40.  8. rexxDoors
  41.  
  42.  9. Additional Notes
  43.  
  44.       a. RexxSpell
  45.  
  46.       b. FileLists 
  47.  
  48.       c. Links
  49.  
  50.       d. Birthdays
  51.       
  52.       e. Sounds
  53.       
  54.  
  55. ********************  Copyrights and Distribution  ********************
  56.  
  57. The ARexx modules in BBBBS are copyright 1990-91-92 Richard Lee Stockton,
  58. and ALL RIGHTS ARE RESERVED. In particular, commercial use of these
  59. programs requires a written agreement with the author. HOWEVER, these
  60. files may be freely distributed and used for non-commercial purposes
  61. AS LONG AS the copyright notices contained within the code remain intact.
  62.  
  63. To contact me for distribution or just more information:
  64.  
  65.                 Richard Lee Stockton
  66.                 21305 60th Ave West
  67.                 Mountlake Terrace, WA 98043-2009
  68.                 
  69.                 Phones:
  70.                 voice = 206-776-1253
  71.                 FAX   = 206-775-7573
  72.                 BBS   = 206-744-1254
  73.                 
  74.                 Telecomm:
  75.                 call the BBS number above and leave a [C]omment to sysop.
  76.                 - OR - send Email to RLStockton on PORTAL or BIX or GENIE
  77.                 - OR - (if you MUST), my Compu-$erve address is 71650,424
  78.  
  79.  
  80.  
  81. ******************   Requirements for operation   ************************
  82.  
  83. BBBBS Requirements:    Assumes standard 1.3 or 2.0 Amiga OS
  84.  
  85. RAM: ~2.5 MEGS of RAM to run. 2.0 MEG without spellchecking.
  86.  
  87. Commercial Software:
  88. (I have *nothing* to do with these, except for using them.)
  89.   BaudBandit  1.50 - $50 retail, ~$30 discounted
  90.   ARexx       1.15 - $50 retail, ~$30 discounted
  91.  
  92.  
  93. Freely Distributable Software:
  94. (comes with BBBBS or are easily found in the PD)
  95.   BBBBS.LZH
  96.     rexx  (must be in your rexx: drawer)
  97.       Answer.baud
  98.       ArcBrowse.rexx
  99.       ArcMsgs.rexx
  100.       baud.rexx
  101.       bbsALPHA.rexx
  102.       BBBBS.baud
  103.       BBBBSdemon.baud
  104.       bbsExtDL.baud
  105.       bbsHOURLY.rexx
  106.       bbsLOCAL.rexx
  107.       bbsMAINT.baud
  108.       bbsNewFile.rexx
  109.       bbsREPORT.rexx
  110.       bbsULDL.rexx
  111.       bbsUSER.rexx
  112.       BuildALPHA.rexx
  113.       BumpLevel.baud
  114.       BumpMember.baud
  115.       BumpTime.baud
  116.       ChangeUserName.rexx
  117.       Contents.rexx
  118.       doorDemon.baud
  119.       EditUsers.rexx
  120.       ForceChat.baud
  121.       Make_BrowseList.baud
  122.       OldEMail.rexx
  123.       Setup.rexx
  124.       ShowFKeys.baud
  125.       ShowLog.baud
  126.  
  127.     rexxDoors  (these are needed for opening and closing cookie, etc.)
  128.       Data (DIR)
  129.         Grins
  130.       Grin_du_jour.rexx
  131.       Moon.rexx
  132.       Time.rexx
  133.  
  134.  
  135.   libraries (must be in your system Libs: drawer)
  136.     arp.library           (VERS 39.1  by CHeath & others on bbs everywhere)
  137.     rexxarplib.library    (VERS  3.0  by Willy Langeveld on bbs everywhere)
  138.     screenshare.library   (VERS  1.52 comes with rexxarplib)
  139.     rexxmathlib.library   (VERS  1.3  by Willy Langeveld on bbs everywhere)
  140.     rexxsupport.library   (VERS 34.9  comes with ARexx 1.15)
  141.     rexxsyslib.library    (VERS 36.23 comes with ARexx 1.15)
  142.  
  143.   commands (must be in your system C: drawer
  144.     QuickSort             (by Marvin Weinstein - ARexxQSort.lzh)
  145.     sound                 (by RLStockton, needed to play BBS Yell.snd)
  146.     boot                  (optional: warm-boots if BBBBS seems frozen)
  147.     lha                   (freely distributable de-archivers...)
  148.     arc
  149.     zoo
  150.     unzip
  151.     dms
  152.  
  153.  
  154. **************************  Organization  **********************************
  155.  
  156. BBS:
  157.  
  158.   BBBBS looks in your s: directory for the file "CONFIG.BBS" which sets all
  159.     preferences including the device where the BBS files are located.
  160.   Within this device, the BBS may use 99 file & 99 message directories.
  161.   Users may be given access levels between 0 (new user) and 99 (super-sysop).
  162.   The lowest sysop level (gets to edit filenotes, maybe edit messages
  163.     depending on level) defaults to 80. Level 99 (and only level 99!) is
  164.     allowed to open a remote Shell and the power to edit ANY file remotely.
  165.   Uload/Dload access to libraries & conferences at or below the user's level.
  166.   Also, a sysop may exclude certain directories from the user's use.
  167.     (file libraries by name, or message conferences by number)
  168.  
  169.  
  170. BBS System File Directories:
  171.  
  172. 'Sysops'       = Holds files for sysop review.
  173.  
  174. 'Information'  = User viewable files. 'I' from the Main Menu.
  175.  
  176. 'Scratch'      = temporary editor files, etc. For debugging.
  177.  
  178. 'BBS_HELP'     = Command summary files, according to level.
  179.  
  180. 'rexxDoors'    = rexx doorway programs
  181.                   Grin_du_Jour.rexx      = 'one-liner' humor
  182.                   Moon.rexx              = the phase of the moon
  183.                   Time.rexx              = the time in words
  184.  
  185.                   rexxDoors/Data/Grins   = data for 'Grin_du_Jour.rexx'
  186.  
  187.                   ...other rexxDoors available in "BBDoors.lha"
  188.  
  189.  
  190. 'BBS_TEXT'     = Text (mostly) files used by the BBS.
  191.                   HELLO          = Sign on message. (19 lines max!)
  192.                   NEW            = New user welcome message.
  193.                   YELL.snd       = (optional) Yell-For-Sysop sound.
  194.                   YELL           = (optional) Yell voice script.
  195.                   WELCOME        = default welcome message
  196.                   WELCOME.Mon, WELCOME.Tue, ..., WELCOME.Sun
  197.                                  = Daily Welcome messages.
  198.                   WELCOME.1225   = Christmas welcome msg., etc.
  199.                   UNTIL.19920201 = displays at logon through Feb 1, 1992
  200.                   GOODBYE        = Logoff message. (local BBS numbers)
  201.                   DEF.NEW_USER   = new user defaults
  202.                   DEF.MEMBER     = member defaults
  203.                   DEF.COURTESY   = courtesy list defaults
  204.                   BIRTHDAY       = displays on user's birthday
  205.                   PROFILES       = intro message to user profiles area.
  206.  
  207. 'FileNotes'    = A dir of dirs. Each dir corresponding to a
  208.                   file library. Within each, a file desciption
  209.                   of the corresponding file in the library.
  210.                   Written by BBBBS.baud, but editable.
  211.  
  212. 'BBS_LIBS'     = Up to 99 file libraries. You select the names of
  213.                   these by editing the file 'BBS:Lists/Libraries'.
  214.                   The BBS sees them by name.
  215.                                 
  216. 'BBS_MSGS'     = Up to 99 message conferences. You select the
  217.                   names of these by editing the file
  218.                   'BBS:Lists/Conferences', but the BBS sees
  219.                   them as MSG1 thru MSG99.
  220.  
  221. 'Lists'        = System lists and lists needed by bbsREXX.
  222.                   Libraries    = see example for proper format
  223.                   Conferences  = see example for proper format
  224.                   Files        = THIS FILE IS WRITTEN BY BBBBS.baud.
  225.                    Under normal circumstances it should NOT be edited
  226.                    by humans.   format: 'filenum dirname filename'
  227.                   Files.ALPHA  = written by BBBBS.baud
  228.                   Courtesy     = List of VIP usernames. A new
  229.                    user on this list is given immediate access.
  230.                    That name is then removed from this list.
  231.                   Excuses      = list of randomly selected reasons why
  232.                    the sysop cannot CHAT right now.
  233.  
  234. *** Following dirs contain files written by BBBBS.baud. DO NOT EDIT! ***
  235.  
  236. 'Numbers'      = LastFile, LastMail, LastMessage1, etc.
  237.                  Also a dir called "Hourly" that contains data
  238.                   for the "average minutes of use per hour" graph.
  239.  
  240. 'Usage'        = Monthly files. Counts hours of modem usage.
  241.  
  242. 'Logs'         = Daily files. Tracks user, time, mail or message activity,
  243.                   uloads/dloads, internal errors, etc.
  244.                   Built in 'log-reader' for sysops.
  245.  
  246. 'EMailFiles'   = Private files left attached to EMail.
  247.  
  248. 'EMail'        = Private mail between users.
  249.  
  250. 'Users'        = User files.
  251.  
  252.  
  253.  
  254. ***************************  Setting Up  *****************************
  255.  
  256. Follow these steps to set up your own BBS..
  257.  
  258. 1. Do Initial Setup  (assumes that bbspath is "BBS:")
  259.  
  260.       a. CD to BBS:            ; the directory to de-lharc the bbs into
  261.  
  262.       b. Lha x BBBBSnn.lha     ; extract respecting original paths
  263.  
  264.       c. COPY BBS:rexx/QuickSort C:    ; ARexx QuickSort
  265.  
  266.       d. COPY BBS:C/#? C:      ; Sound and other C: type programs
  267.  
  268.       e. COPY BBS:S/#? S:      ; CONFIG.BBS, Bandit.Keys, Bandit.Config
  269.  
  270.       f. COPY BBS:rexx/#? REXX:  ; NOTE: 450K of rexx programs!
  271.       
  272. 2. Make sure that "C:DATE" returns the correct time and date. The BBS
  273. needs to know the correct time and date for many of its routines.
  274.  
  275. 3. Use a Text editor to edit the following lists. These lists can be
  276. changed or edited anytime. The libraries may be re-ordered at any time,
  277. but the message conferences can only be added to, not re-shuffled. That
  278. is, once you associate a message conference title with its number, and
  279. messages are actually written to that conference, you MUST keep that same
  280. number associated with that conference title. (This is because messages
  281. are kept in MSG1, MSG2, etc. while files are kept in directories created
  282. with the title that YOU give it.  Note: No spaces are allowed in titles).
  283. You may change the CONFERENCE title, but the old messages in that
  284. conference will still refer to the old title. It is possible to change
  285. a LIBRARY title, but you also have to rename the directory, and update
  286. all references to the old dir (which can be quite a few!), so I advise
  287. against it.  Use care in all title selections and save yourself future
  288. problems with re-naming.
  289.  
  290.      a. BBS:Lists/Conferences    (message conference names)
  291.  
  292.      b. BBS:Lists/Libraries    (file library names)
  293.  
  294. Note: If you wish to review uploaded files before public posting, you need
  295.       to be certain that the highest possible non-sysop directory is called
  296.       "Sysops", as this is where new uploads will be saved.
  297.  
  298.      c. BBS:Lists/Courtesy   (these names receive INSTANT validation)
  299.  
  300.      d. BBS:Lists/Excuses  (good reasons why the sysop can't chat right now)
  301.  
  302. 4. Use a Text editor to edit "S:CONFIG.BBS" to your preferences.
  303. IMPORTANT! Test your "c:info" from the CLI with your "info-compatible"
  304. device name to make sure that the blocks free amount is being returned.
  305. See BBS_TEXT/CONFIG.BBS for line by line a description of the options.
  306. Note that if line 30 of the config is 1, the BBS stays "up" all the time,
  307. which means the CONFIG.BBS and the various Lists are not reloaded each
  308. call. DO NOT change the file libraries using bbsLOCAL.rexx while the BBS
  309. is in resident mode as this will confuse the BBS and files will be lost.
  310. To exit resident, use SHIFT-F2 from BaudBandit to setclip BBS_QUIT=QUIT.
  311. It may take up to two minutes for BBBBS to notice that it is supposed to
  312. unload before it will actually halt the rexx process. Watch for the blue
  313. dot to disappear from the upper right part of the BaudBandit titlebar.
  314.  
  315. If you want the default sysop name to be something other than "SYSOP":
  316.   a. The name should be in all caps with the "_" character substituted for
  317.        spaces. (ie, RICHARD_LEE_STOCKTON).
  318.   b. Then, put "SYSOP" in the exclusion list to make sure no one else can
  319.        use "SYSOP" as their user name.
  320.   c. Delete the file "Users" in the "Lists" drawer of the BBS.
  321.   d. Finally, Rename BBS:Users/SYSOP BBS:Users/<your sysop name>
  322.  
  323. 5. Use the Text editor on the following textfiles to be read by the user.
  324.  
  325.     a. BBS:BBS_TEXT/HELLO     /* this is the title message */
  326.  
  327.     b. BBS:BBS_TEXT/NEW       /* message to new users */
  328.  
  329.     c. BBS:BBS_TEXT/WELCOME   /* once-a-day welcome to users */
  330.  
  331.     d. BBS:BBS_TEXT/GOODBYE   /* last thing the user sees */
  332.     
  333.     e. BBS:Information/SYSTEM_INFO   /* what Amiga model, OS, etc */
  334.  
  335. 6. You may also wish to edit the default user files in the BBS_TEXT drawer,
  336.     but I suggest leaving them alone until you gain a better understanding
  337.     of the BBS system.
  338.  
  339.     a. DEF.NEW_USER   /* all lines are used */
  340.  
  341.     b. DEF.COURTESY   /* all lines are used */
  342.  
  343.     c. DEF.MEMBER     /* ONLY time, level, and exclude_dirs are used */
  344.  
  345. 7. Start the LOCAL BBS by typing  "rx bbsLOCAL SETUP". Enter "sysop"
  346. (or the name you changed it to) when asked to enter your name, then
  347. enter "password" when asked for a password. This will construct the
  348. directories you specified in BBS:Lists/Libraries, (if they don't already
  349. exist).. likewise, the message conferences will be constructed, if needed.
  350. You will then enter the bbs _AS IF_ it were running from the modem,
  351. although Baud Bandit is not needed at all.
  352.  
  353. 8. Select "Y" to edit your personal data. CHANGE YOUR PASSWORD!!
  354.  
  355. 9. Read the BBBBS.COMMANDS file in [I]nformation for general command
  356. information, and take a look around the board. Try out some things a
  357. user would try.
  358.  
  359. 10. Use "G" to logoff which will rewrite your user file.
  360.  
  361. 11. Start BaudBandit. Check BB's Macro display. The important thing
  362. here is to make sure that "\mAnswer.baud" is in "RING" portion of BB's
  363. configuration.
  364.   2400 baud (and below) operation:
  365.     Handshake should be set to "NONE" (otherwise CTRL-S can hang the BBS).
  366.     AutoBaud should be set to "ON" and the baud rate to the same value
  367.      you have set in BBS:BBS/CONFIG as the Maximum baudrate.
  368.   9600 baud (and above) operation:
  369.     Handshake should be set to "7-Wire".
  370.     AutoBaud should be set to "OFF" and the baud rate set to the maximum
  371.      "terminal-to-modem" baudrate (19200 max for less than 68020 cpu).
  372.     I have used Practical Peripherals modems and the setup strings are:
  373.        9600SA    AT &F M0 &C1 &D3 S95=47 &W
  374.       14400FXSA  AT &F M0 W1 &C1 &D3 &T5 S37=11 S95=47 S118=2 &W
  375.  
  376.         &F      = factory defaults
  377.          M0     = turn speaker off  [optional]
  378.          W1     = enable progress messages
  379.         &C1     = track DCD
  380.         &D3     = monitor DTR and reset to power up conditions
  381.         &T5     = disable remote testing  [optional]
  382.          S37=11 = highest modem to modem rate is 14400
  383.          S95=47 = all progress messages and modem-modem speed report
  384.          S118=2 = LCD display 2 seconds per line of info.  [optional]
  385.         &W      = save to modem RAM so ATZ will recall these settings
  386.   
  387.      These may or may not work for you, but at least it's a place to start.
  388.      Note that you only have to give this command once, then the "ATZ"s
  389.       that BBBBS sends will reset your modem to this default.
  390.  
  391. There are Bandit.Config files provided for both 9600/14400 and 2400.
  392. If you make any changes remember to save them.
  393.  
  394. NOTE! Your modem MUST be set so that you can see verbose responses from
  395. your modem on your BB screen (ie, RING, CONNECT 9600/ARQ (or whatever),
  396. NO CARRIER, OK, etc). THIS IS _THE_ MOST COMMON MISTAKE THAT WOULD-BE
  397. SYSOP SEEM TO MAKE! Also, baudrates reported by the modem should be the
  398. modem-to-modem baudrate. Correct BBS operation depends on these messages.
  399.  
  400. 12. If you have RAM to spare, give yourself a large capture buffer in
  401. BaudBandit, especially if you will be debugging. You can use BB's
  402. review buffer to study what the user did, in what order, and what
  403. happened. I have mine set to about 150k..
  404.  
  405. 13. To set up the BBS to start automatically in the background, add
  406. these lines to your startup-sequence:
  407. (assumes that BaudBandit is in the BBS: drawer)
  408.  
  409.     assign rexx: dh0:rexx  ; Edit dh0:rexx to YOUR rexx drawer.
  410.     rx setup
  411.     BBS:BB                 ; Edit this to YOUR BaudBandit path
  412.     WaitForPort BAUD
  413.     ;rx Baud OFF  ; uncomment this line to close BB's screen after startup
  414.     run rx "ADDRESS BAUD;Send '\mBBBBS.baud'"
  415.  
  416. 14. You may also wish to install BBDoorsnn.lha (extra rexxDoors for BBBBS),
  417. SpellBBS.lzh (the spell-checker), and TODAY.lha ("today in history" program).
  418. Also note that many BBBBS sysops have written various alterations, rexxDoors,
  419. sysop-help programs, and more. Search your BBS for the keyword "BBBBS".
  420.  
  421. 15. At last, nothing left to do but sit back and wait for callers, and soon
  422. become beloved sysop to billions of users...  ;-)  ;-)
  423.  
  424.  
  425.  
  426. *********************  User data file  ***************************
  427.  
  428.  1. name:
  429.  2. street:
  430.  3. city, st zip:
  431.  4. phone:
  432.  5. password:  (only visible by user and super-sysop)
  433.  6. protocol:
  434.  7. lines per page:
  435.  8. preferences:   may include MENU or MENUS, COLOR, STREET, PHONE
  436.  9. Computer:
  437. 10. Interests:
  438. 11.     Time: <nn> minutes <nn> more times today
  439. 12. first date on: datestamp  timestamp
  440. 13.  last date on: datestamp  timestamp
  441. 14.   upload: <nn> files <nn> bytes  day month year
  442. 15. download: <nn> files <nn> bytes  day month year
  443. 16. lastfile: lastfile  datestamp  timestamp
  444. 17. rtio/eml: dl/ul_ratio  email_written  last_email_read_(sysop_only)
  445. 18. winnings: <nn>
  446. 19.  time on: <nn> days <nn> hours <nn> minutes in <nn> calls.
  447. 20.    level: <nn>
  448. 21. exclude directories list:     (only viewable/editable by sysops)
  449. 22. msg_read: MSG1 MSG2 MSG3 ... MSG<last> (-1 in MSGslot = conference OFF)
  450. 23. msg_writ: MSG1 etc.
  451. 24. msg_mark: MSGdirnum/MSGnum MSGdirnum/MSGnum... (conf msgs TO this user)
  452. 25. used to temporarily store filelist to be downloaded.
  453. 26. QUICK exclude list  (files excluded from bbsQUICKOUT archives)
  454.  
  455. Default data for New Users is stored in BBS_TEXT/DEF.NEW_USER
  456. Default data for Courtesy List Users is stored in BBS_TEXT/DEF.COURTESY
  457. Only lines 6-22 of these files are used, the rest are ignored.
  458.  
  459. Default data for Members is stored in BBS_TEXT/DEF.MEMBER
  460. Only lines 11, 20, 21 and 22 of this file is used, the rest are ignored.
  461.  
  462.  
  463. **********************  bbsLOCAL.rexx  ***************************
  464.  
  465. This is a multi-tasking (within limits, see below) rexx program that
  466. you as the sysop may run from a Shell or CLI. In most ways it is just
  467. like the regular BBS program, so you see what your users see. However,
  468. it is not connected to BaudBandit in any way, and in fact, does not
  469. use the serial port (or your modem) at all. Upload and download functions
  470. are transmuted into copy (with the arp requester), and some functions
  471. are left out (like the check for DCD, etc.).  It DOES look at the same
  472. data that BBBBS.baud looks at, and reasonable care must be taken not
  473. to add files to the file libraries while a user is also adding a file
  474. to the libraries. Likewise, don't write EMail while the user is writing
  475. email, and don't write messages while the user is writing messages IN
  476. THE SAME CONFERENCE (messages CAN be written in different conference at
  477. the same time, one by user, one by sysop).
  478.  
  479.          CLI> rx bbsLOCAL SETUP
  480.  
  481.  
  482. Copying Files Direct Into the Libraries:
  483.  
  484. METHOD 1:
  485.      Run bbsLOCAL and use the Upload command. The arp file requester
  486. will appear so you can copy the files into the correct libraries. After
  487. the copy, you will enter a note just as if you uploaded the file, and
  488. the system filelists will be updated.
  489.  
  490. METHOD 2:
  491.     First copy the files to the correct libraries. Then run bbsLOCAL
  492. (or call) and edit (in this case, create) the file description using
  493. the "%" sysop command.
  494.  
  495. In either case, when BBBBS sees that this note has been created,
  496. it adds the file to the other system filelists, and increments the
  497. count in "Numbers/LastFile".
  498.  
  499.  
  500.  
  501. *************************  Macros  *******************************
  502.  
  503. Note that if called from BB with a user online, these macros will not
  504. take effect if the user is waiting at a menu. You can press return
  505. yourself to force the macro if it looks like the user is sleeping
  506.  
  507.  - Function Keys -
  508.  
  509. F1 - ForceChat.baud - Forces user into chat at next prompt.
  510.  
  511. F2 - Twit.baud - TWIT-KEY, forces logoff of current user at next prompt.
  512.  
  513. F3 - BumpTime.baud - Opens a requester allowing you to set this users
  514.        maximum time in minutes for this session. It will take effect at
  515.        the next prompt. This is a temporary change, this session only.
  516.  
  517. F4 - BumpMember.baud - Member values are taken from "BBS_TEXT/DEF.MEMBER".
  518.        Takes effect at the next prompt. This change is saved to the users
  519.        data file. It is permanent.
  520.  
  521. F5 - BumpLevels.baud - Opens a requester allowing you to set the level and/or
  522.        upload to download ration for this user. It will take effect at the
  523.        next prompt. This change is permanently saved to the users data file.
  524.  
  525. F6 - Close Function Key Help Window
  526.  
  527. F7 - ShowLog.baud - Displays today's log on BB's screen, BBS running or not.
  528.  
  529. F8 - An inline macro to fetch the clip "BBS_totalusage" and display monthly
  530.        usage in hours and minutes.
  531.  
  532. F9 - Baud.rexx OFF - Turns BaudBandit's screen off (improves speed). While
  533.        the screen is off THE CAPTURE BUFFER STAYS OPEN! This means you can
  534.        leave the screen off for fastest response, then, when the modem tells
  535.        you the user has logged off, turn the screen on again (from CLI
  536.        "rx Baud") and read the review buffer (SHIFT-HELP).
  537.  
  538. F10 - Opens a Function Key Help Screen on BaudBandits screen.  F6 to close.
  539.  
  540.  
  541.  - SHIFTED Function keys -
  542.  
  543. S1 - Starts up BBBBS.baud.
  544.          WARNING! Don't start BBBBS while it is already running in this BB!
  545.  
  546. S2 - Sets the "UnLoad" flag.
  547.        BBBBS will exit after the current call, or within 60 seconds.
  548.  
  549. S3 - UnSets the UnLoad flag (in case you change your mind)
  550.  
  551. S4 - Sets the Maintenance flag.
  552.       BBBBS.baud or Answer.baud will answer the phone, give a "Sorry, busy!"
  553.       message, and hang up.
  554.  
  555. S5 - UnSets the Maintenance flag.
  556.  
  557. S6 - Set the modem "off-hook". Users see busy signal.
  558.  
  559. S7 - Reset modem to "on-hook" (hangup).
  560.  
  561. S8 - Run BBBBSdemon.baud.
  562.  
  563. S9 - Display total RAM available on the screen, chip+fast.
  564.  
  565. S10 - Enter message to be sent to current user at first opportunity.
  566.  
  567.  
  568.  
  569.                      ---  Other Macros  ---
  570.  
  571. rexx:BuildALPHA.rexx - rebuilds the file & alpha lists from the ground up.
  572.    BBBBS should preferably not be running so that a user won't upload in
  573.     the middle of your rebuild and overwrite the list. This macro sets
  574.     a clip that forces BaudBandit to give a BUSY message to any caller.
  575.     After buildALPHA.rexx is finished, the clip is cleared, and BBBBS
  576.     will go back online.
  577.     BuildALPHA.rexx may take a while. 1400 files=15 mins on 68000 Amiga.
  578.  
  579. rexx:bbsULDL.rexx - Reads the CURRENT file library descriptions and writes
  580.    statistics to "Information/STATS.ULDL". This will happen automatically
  581.    once a day if STATS.ULDL exists! To disable this function, just delete
  582.    "Information/STATS.ULDL".
  583.  
  584. rexx:bbsUSER.rexx - Reads the CURRENT userfiles and writes statistics to
  585.    "Information/STATS.USER". This will happen automatically once a day
  586.    if STATS.USER exists! To disable this function, just delete the file
  587.    "Information/STATS.USER".
  588.  
  589. ChangeUserName.rexx - To change the user name HACK_MASTER", from a CLI
  590.     enter "rx ChangeUserName HACK_MASTER". Just press return to use his/her
  591.     real name, or enter the new name. UserFile, Email and EmailFiles will
  592.     be updated.  This function may also be accessed from within BBBBS.
  593.  
  594. bbsREPORT.rexx - Constructs a report of inactive users and saves it as
  595.     email to sysop. NOTE: If "VIP_USER" appears on the user-data line that
  596.     contains the excluded libraries, that user will be excluded from the
  597.     list of inactive users. If a file report is requested, the file libs
  598.     will be counted and searched for possible problems. This entire report
  599.     is run as a background process thru the AREXX port and the resulting
  600.     archive left as email with an attached file.
  601.  
  602. BBBBSdemon.baud - Runs independently of BBBBS.baud and looks for a
  603.     condition where there is no user online, but BBBBS hasn't reset, and
  604.     tries to fix it. If it fails to fix it after a few tries then c:boot
  605.     is run. If c:boot does not exist, the demon runs "c:hi" which tries to
  606.     halt all currently running rexx programs.
  607.  
  608. OldEmail.rexx - Run from CLI to list Email (and emailfiles) older than a
  609.     given number of days. Output may be redirected to a file. The sysop is
  610.     also given the chance to delete each selected email or emailfile.
  611.  
  612. bbsQUICK.rexx - Offline read/reply module for BBBBS.
  613.     See the bbsQUICK.DOC and bbsQUICK.REVISION for more info.
  614.  
  615. bbsQUICKIN.rexx - Processes QUICKIN.lha archive uploaded by user. The
  616.     Super-Sysop can copy a QUICKIN.lha file by hand to his EmailFiles
  617.     drawer and then type "rx bbsQUICKIN" in a CLI/Shell to process.
  618.  
  619. bbsQUICKOUT.rexx - Constructs archive of latest BBS activity for the
  620.      use of bbsQUICK.rexx. You can just type "rx bbsQUICKOUT" in a
  621.      CLI/Shell and a QUICKOUT archive will be constructed for the
  622.      sysop using his/her current file and message counters.
  623.  
  624.  
  625.            ------- Internal Macros run ONLY by BBBBS --------
  626.  
  627.   bbsLOGON.baud - Runs right after the password is entered. You can
  628.      have your own ARexx (or whatever) routines run here.
  629.      See bbsLOGON.baud for more information on usage.
  630.  
  631.   bbsLOGOFF.baud - Runs just before user logs off (before GOODBYE text).
  632.      See bbsLOGOFF.baud for more usage information.
  633.  
  634.   bbsALPHA.rexx - Controls the archiving of the alpha filelist. If a
  635.      name and path is given for an arcfile, "Lists/Files.ALPHA" will
  636.      be archived into it using the archiver in the config file.
  637.  
  638.   bbsMaint.baud - Runs if the current messages online exceed the maximum
  639.      set in "CONFIG.BBS". Deletes the oldest messages that don't have the
  640.      "SaveMe!" flag set (2 exclamation points as the first 2 characters).
  641.  
  642.   doorDemon.baud - Runs while the user is running a rexx door program.
  643.      Checks carrier for hangups and time elapsed. More infomation below.
  644.  
  645.   ArcMsgs.rexx - Archives new (or selected) messages from the conference
  646.      area using Lharc. This is done as a background process using the AREXX
  647.      port, and the resulting archive left as email with an attached file.
  648.  
  649.   MakeBroweList.baud - Archives user selected file descriptions using
  650.      Lharc. This is done as a background process using the AREXX port,
  651.      and the resulting archive left as email with an attached file.
  652.  
  653.   bbsHourly.rexx - graphic display of average minutes of use hour by hour.
  654.  
  655.   Contents.rexx - Display the contents of an archived file
  656.      (.arc .dms .lha .lzh .zip .zoo) assuming appropriate c: programs.
  657.  
  658.   bbsExtDL.baud - Allows access to CD-ROM drives, extra floppies,
  659.      harddrives, partitions, or just assigned areas to be treated as
  660.      "Read-Only" devices.
  661.      Enter a space separated device list on line 10 of CONFIG.BBS.
  662.      Devices on this list are handled separately from the rest of the BBS
  663.       file libraries, and do not have filenotes, unless they are referenced
  664.       using "links" (see below).
  665.  
  666.   bbsNewFile.rexx - If activated, automatically makes an archive copy of
  667.      each file uploaded to the BBS and sets the archive bit of the file
  668.      in the library. TO ACTIVATE this feature, put bbsNewFile.rexx into
  669.      a text editor and replace "NO_DIR:" with a valid pathname.
  670.  
  671.  
  672.  
  673. *****************************  rexxDoors  ****************************
  674.  
  675. rexxDoors:
  676.  
  677. Almost ANY rexx program that uses NO GRAPHICS OTHER THAN CHARACTERS can
  678. be easily made into a rexxDoors program. Just add these lines at the top:
  679.  
  680.     CR="0D"x
  681.     SIGNAL ON BREAK_C
  682.     SIGNAL ON BREAK_E
  683.  
  684. and these lines at the bottom, just before the main RETURN or EXIT:
  685.  
  686.     BREAK_C:
  687.     BREAK_E:
  688.  /* <-- might put "SetClip('BBS_winnings',winnings)" routine here */
  689.     EXIT;
  690.  
  691. and lastly, search the text for all instances of "SAY" and add "||CR" to
  692. the END of each SAY command.
  693.   SAY 'Here we go.' becomes SAY 'Here we go.'CR or SAY 'Here we go.'||CR
  694.  
  695. If you want the rexxDoor to check for a disconnect, you can call the
  696. following subroutine periodically, ie, IF checkdcd() THEN SIGNAL BREAK_C
  697.              checkdcd:
  698.              IF ADDRESS()~='BAUD' THEN RETURN 0
  699.              dcd
  700.              IF RC=0 THEN RETURN 1
  701.              RETURN 0
  702.  
  703. Any "PULL" commands in the rexx script will take input from the user,
  704. and any "SAY" commands will be sent out the modem.
  705.  
  706. All rexxDoors programs are sent the user name and his "winnings" as the
  707. command argument. ie,
  708.  
  709.        doorprogram.rexx(name winnings 0_or_seconds colorflag)
  710.  
  711. If cash_or_seconds=0, then we are playing for play-money cash (which is
  712. remembered from session to session). If cash_or_seconds>0 then the user
  713. is playing for the seconds remaining in this session. There is no
  714. requirement that the rexxDoors program use ANY of these arguments. If
  715. the rexxDoors program should return a "winnings" amount, it should do a
  716. "CALL SETCLIP('BBS_winnings',winnings)" before it returns.
  717.  
  718. rexxDoors can also connect non-rexx programs to the BBS.
  719.   1. Program must output ONLY to the CLI. (no graphics, no windows, etc.)
  720.   2. Then write a little program like this and put it in rexxDoors. Note
  721. that in this example, the Dungeon files have been put in a drawer within
  722. the rexxDoors drawer, rexxDoors/Data. This location is arbitrary.
  723.  
  724. -----------------------------cut-here----------------------------------
  725.  
  726. /* Dungeon.rexx  - starts up AmigaDungeon with redirects */
  727.  
  728. LF='0A'x
  729. CR='0D'x
  730. bbspath=GETCLIP('BBS_path')
  731.  
  732. PARSE ARG name winnings flag colorflag .
  733.  
  734. /* give any addition information needed by the user */
  735.  
  736. SAY CR
  737. SAY 'Your terminal should add a carraige-return to each received linefeed.'CR
  738. SAY CR
  739. SAY '            No carraige-returns are generated by Dungeon!'CR
  740. SAY CR
  741. SAY 'Enter INFO for general game information. Enter HELP for help and hints.'CR
  742. SAY CR
  743. SAY '       Loading...  Please wait for prompt character > to appear.'CR
  744. SAY CR
  745.  
  746. /* point this macro at the Dungeons drawer so that Dungeon can find its data */
  747. /* This may or may not be necessary for your particular application. */
  748.  
  749. CALL PRAGMA('D',bbspath'rexxDoors/Data')
  750.  
  751. /* Run the game, redirecting input and output to the console (BaudBandit) */
  752.  
  753. ADDRESS COMMAND 'CD' bbspath'rexxDoors/Data'LF'dungeon <* >*'
  754.  
  755. EXIT;
  756.  
  757. /* end of Dungeon.rexx */
  758.  
  759. -----------------------------cut-here----------------------------------
  760.  
  761. NOTE:
  762. Although the game program is now in control, if the user exceeds his time,
  763. or hangs up, a program that is running in the background, bbsDEMON.baud,
  764. will send a BREAK (CTRL-C) to the game, and a "go to logout" to the BBS.
  765. If your game won't stop when it gets a CTRL-C, you'll have to rewrite the
  766. DEMON to send "QUIT" or whatever magic your game requires.
  767.  
  768.  
  769.  
  770.  
  771. *******************************   Misc   *****************************
  772.  
  773. REXXSPELL:
  774.  
  775. To use RxSpell (SpellBBS.lzh) with BBBBS, simply set the proper path
  776. and turn on spellchecking in CONFIG.BBS. You must have plenty of RAM
  777. to use spellchecking as it may use 300k-500k all by itself. On the
  778. other hand, it's fairly fast once it is all been loaded.
  779.  
  780.  
  781.  
  782. RATIO:
  783.  
  784. Download/Upload Ratio:  User data line 17, Word 1    -  0=DISABLED
  785.  
  786.    Example: 5 means user will be refused downloading if
  787.        DownloadBytes divided by UploadBytes exceeds 5.0,
  788.        and bbs_preferences has Down/Upload Ratios set to ON (1).
  789.  
  790.  
  791.  
  792.  
  793. FILE LISTS:
  794.  
  795.   If you feel you really MUST get in there and futz around with a file,
  796. remember this. Changes in a file or filenote can effect _5_ different
  797. files (at least). The file itself (say, "BBS_LIBS/Text/MyPoem.lzh"),
  798. the filenote ("FileNotes/Text/MyPoem.lzh"), the general filelist (this
  799. file, "Lists/Files", is VERY important to the system!), the alphabetical
  800. list ("Lists/File.ALPHA"), and the upload counter ("Numbers/LastFile").
  801. It is best to do file maintenance from within the BBS and let the
  802. software worry about what files need changing and rearranging.
  803.  
  804.  
  805.  
  806.  
  807. LINKS:
  808.  
  809.    To add a file to the libraries that will be located somewhere other
  810. than the normal BBS_LIBS...
  811.  
  812. 1. "Point" BBBBS at the appropriate library by entering the library
  813. number (BBBBS will try to show new files. When it is thru, the current
  814. library will be the one you picked).
  815.  
  816. 2. Attempt to edit a filenote using the "%" command, and the name of
  817. the file you wish to add. When asked if this file is "on another device?"
  818. answer "Y" and enter the FULL path and filename for the file. This "link"
  819. is stored in the filecomment of the description.
  820.  
  821. 3. Now this file will be treated as if it is in the libraries, stats will
  822. be kept on it, etc., but it will be downloaded from the link path.
  823.  
  824.  
  825. You can also move a file already in the BBS_LIBS to another device.
  826. Handy when the only way to expand your BBS is to purchase a second HD,
  827. or perhaps redirect some of the filelist to be downloaded from a CD-ROM,
  828. external floppy, etc.
  829.  
  830. 1. move the file, but not the filenote.
  831.  
  832. 2. use the C:FileNote command to enter the new path to the old file in
  833.     the comment field of the file description. Use the *full* name, ie
  834.  
  835. C:FileNote BBS:FileNotes/Text/Thisfile.lha "HD2:Overflow/Text/Thisfile.lha"
  836.  
  837. Note that the file report will tell you to compare files and filenotes
  838. in that directory, but won't list a filename, as it does for files that
  839. don't have filenotes yet. Just ignore it.
  840.  
  841.  
  842.  
  843.  
  844. BIRTHDAYS:
  845.  
  846.    Each user is supposed (but not required) to enter his birthday when
  847. filling out the application for membership. This is used in computing
  848. the age of the average BBS user. In addition, if the user calls BBBBS
  849. on his birthday, she will see a simple birthday greeting. If a textfile
  850. called "BBS_TEXT/BIRTHDAY" exists, that file will also be displayed.
  851.  
  852.  
  853.  
  854.  
  855. SOUNDS:
  856.  
  857. Some people with newer Amigas have been having trouble with BaudBandit's
  858. Beep command not working and causing the BBS to hang, so I have removed
  859. all of these commands as of BBBBS version 5.9 and replaced them sounds.
  860. Line 28 of CONFIG.BBS now controls whether all sounds are on/off, not
  861. just the YELL sound.
  862.  
  863. The following sounds are called by BBBBS. You may substitute your own
  864. sounds instead, just rename them to one of the choices below. You can
  865. disable an individual sound simply by renaming, moving, or deleting it.
  866.  
  867. LOGON     - Sounds right after password is accepted.
  868.  
  869. NEW_USER  - Sounds when new user replies [Y]es, she wants to register.
  870.  
  871. YELL      - Sounds on "!" command from menu. "!" also triggers voice, so
  872.              this sound needs to be fairly small and short.
  873.  
  874. ALERT     - This sound should also be short as it is sounded once for
  875.              "LOST CARRIER", twice when user has been idle too long, and
  876.              3 times in a row when modem did not return OK after reset.
  877.  
  878. LOGOFF    - Sounds after user data is saved for the last time.
  879.  
  880.  
  881. All sounds are played by "Sound", which should be in your C: directory.
  882. The syntax used is "c:run >nil: c:sound <soundfile>", so you'll need to
  883. have "run" in your C: directory too.
  884.  
  885. If you want a sound to occur when the modems first CONNECT, enter
  886.  
  887. DCDHi   \m"c:run >nil: c:sound <soundfile>"
  888.  
  889. in BaudBandit's config file (in the DCDHi field). Replace <soundfile>
  890. with the FULL PATH to your chosen soundfile. DCDLow usually happens too
  891. close to the LOGOFF sound to be of much use.
  892.  
  893.  
  894.  
  895.                    ***  G O O D    L U C K  ***
  896.  
  897.  
  898. ***********************  end of BBBBS.doc  ***************************
  899.